home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / System7 tools / M / Menu Events 1.1.1.sit / Menu Events 1.1.1 / Menu Events Help.rsrc / STR#_1026.txt < prev    next >
Encoding:
Text File  |  1994-04-12  |  3.4 KB  |  171 lines
  1. 
  2.  
  3. 
  4.  
  5. x
  6.  
  7. x
  8.  
  9. √•What Does Menu Events Do?
  10.  
  11. 
  12.  
  13. 
  14.  
  15. Menu Events is a system extension.  Once you have placed it in your
  16.  
  17. Extensions folder and restarted your Macintosh, it adds a small suite of
  18.  
  19. Apple events (‚ÄúMenu events‚Äù) to the set supported by every
  20.  
  21. high-level-event-aware application.
  22.  
  23. 
  24.  
  25. 
  26.  
  27. Many people are justly wary of control panels and system extensions,
  28.  
  29. because of the conflicts they often cause with System software and with
  30.  
  31. each other.  These conflicts usually result from competitive trap patching.
  32.  
  33. 
  34.  
  35. Menu Events does not patch any traps at system startup.  It works by
  36.  
  37. installing Apple event handlers in the system dispatch table.  These
  38.  
  39. handlers are not in conflict with any others, because they are bound
  40.  
  41. specifically to the Menu event class.  Menu Events does patch some traps
  42.  
  43. ‚Äúon the fly‚Äù to simulate menu selection, but the patches remove
  44.  
  45. themselves immediately.
  46.  
  47. 
  48.  
  49. There are three events defined in the suite, and they work as follows.
  50.  
  51. See the section entitled ‚ÄúMenu Events Suite‚Äù for more information on the
  52.  
  53. Menu Events suite.
  54.  
  55. 
  56.  
  57. 
  58.  
  59. 
  60.  
  61. xQuery Menu List Event
  62.  
  63. 
  64.  
  65. This event, with no parameters, queries the menu list of the target
  66.  
  67. application.  If the application is not background-only and has a menu bar,
  68.  
  69. it will return a list of records, each containing a menu ID (integer), a title
  70.  
  71. (string), and an enable/disable (Boolean) parameter.  If you do not know
  72.  
  73. the IDs of the target application‚Äôs menus, this is how to find out.  Be
  74.  
  75. aware that menu IDs do not have to agree with 'MENU' resource IDs,
  76.  
  77. though they often do.
  78.  
  79. 
  80.  
  81. 
  82.  
  83. System menus (Keyboard, Help, Application) and pop-up menus do not
  84.  
  85. appear in this list, but the Apple menu and hierarchical menus do.
  86.  
  87. 
  88.  
  89. 
  90.  
  91. 
  92.  
  93. xQuery Menu Event
  94.  
  95. 
  96.  
  97. This event, given a menu ID (integer) parameter, queries the items of a
  98.  
  99. certain target application menu.  If the application has a menu with that
  100.  
  101. ID, be it a regular, system, hierarchical, or pop-up menu, it will return a
  102.  
  103. list of records, each containing a menu item ID (integer), an item title
  104.  
  105. (string), an enable/disable (Boolean), a mark character (integer), an icon
  106.  
  107. ID (integer), a style value (integer), and a Command character (integer)
  108.  
  109. parameter.  The items are numbered starting from 1 at the top end of the
  110.  
  111. menu.  Separators appear as disabled items with an item title of ‚Äú-‚Äù.
  112.  
  113. 
  114.  
  115. 
  116.  
  117. This event does not work for menus which use a non-standard menu
  118.  
  119. definition function ('MDEF').
  120.  
  121. 
  122.  
  123. 
  124.  
  125. 
  126.  
  127. xSelect Menu Item Event
  128.  
  129. 
  130.  
  131. This event, given a menu ID (integer) and a menu item ID (integer)
  132.  
  133. parameter, asks the application to act as though the user pulled down that
  134.  
  135. menu and selected that item.  This does not work for the Keyboard and
  136.  
  137. Application menus, which are not under the control of the application, nor
  138.  
  139. for the upper (System-defined) part of the Help menu, but it works for
  140.  
  141. any regular, application-defined, enabled menu item.
  142.  
  143. 
  144.  
  145. 
  146.  
  147. This event does not work for menus which use a non-standard menu
  148.  
  149. definition function ('MDEF').
  150.  
  151. 
  152.  
  153. This event brings the target application to the front before forcing the
  154.  
  155. menu selection upon it.  If the sender was on the same machine, and was
  156.  
  157. previously in front, it returns to the front after the menu action is
  158.  
  159. complete.
  160.  
  161. See the section entitled ‚ÄúHow Does Menu Events Work?‚Äù for more
  162.  
  163. information about the method by which Menu Events activates the target
  164.  
  165. application.
  166.  
  167. 
  168.  
  169. 
  170.  
  171.